Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 1 - Appearance Manager Reference / Appearance Manager Functions

Drawing Appearance-Compliant Menus /

DrawThemeMenuBarBackground

NEW WITH THE APPEARANCE MANAGER

Draws an Appearance-compliant menu bar background.

pascal OSStatus DrawThemeMenuBarBackground (
                     const Rect *inBounds,
                     ThemeMenuBarState inState,
                     UInt32 inAttributes);

inBounds

On input, a pointer to a rectangle providing global coordinates that specify the menu bar's initial size and location.

inState

A value specifying the state (active or selected) in which the menu bar is to be drawn; see "Appearance-Compliant Menu Bar Draw State Constants".

inAttributes

Reserved. Pass 0.

function result

A result code; see "Result Codes".

DISCUSSION

Use the DrawThemeMenuBarBackground function if you are writing a custom menu bar definition function and wish to coordinate with the current theme. An Appearance-compliant menu bar background is drawn in the rectangle passed in the inBounds parameter.

SPECIAL CONSIDERATIONS

Make sure Appearance Manager 1.0.1 is present before calling the DrawThemeMenuBarBackground function. See "Appearance Manager Gestalt Selector Constants" for details on how to determine if the Appearance Manager is present and what its version is, if so.